home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / drt100.zip / DRT.DOC < prev    next >
Text File  |  1991-09-06  |  49KB  |  1,072 lines
  1.  
  2.                         DOOR Registration Telethon v1.00
  3.                       Copyright (C) 1991 by Robert Edwards
  4.                            -=< ALL RIGHTS RESERVED >=-
  5.  
  6.  
  7. DRT
  8. -------------------------------------------------------------------------------
  9.  
  10. DOOR Registration Telethon SysOp's Manual
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                      Copyright (C) 1991 by Robert Edwards
  37.  
  38.                              ALL RIGHTS RESERVED
  39.  
  40.  
  41.                                 Robert Edwards
  42.                      NSGA # 6725, Winter Harbor, ME 04693
  43.  
  44.                               BBS (207)963-2683
  45.                              Voice (207)963-7056
  46.  
  47.  
  48.                         DOOR Registration Telethon v1.00
  49.                       Copyright (C) 1991 by Robert Edwards
  50.                            -=< ALL RIGHTS RESERVED >=-
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.                                COPYRIGHT NOTICE
  58.  
  59. DRT is Copyright (C) 1991 by Robert Edwards.
  60.  
  61. This document is Copyright (C) 1991 by Robert Edwards.
  62.  
  63. No parts of DRT or this document may be copied in part or in whole, except as
  64. provided in the license included with DRT.
  65.  
  66.  
  67.  
  68.  
  69.                                   DISCLAIMER
  70.  
  71. Robert Edwards and The RaJE Computer Emirates make no warranty of any kind,
  72. either express or implied, including but not limited to implied warranties of
  73. merchantability and fitness for a particular purpose, with the respect to this
  74. software and accompanying documentation.
  75.  
  76.  
  77.  
  78.  
  79. IN NO EVENT SHALL ROBERT EDWARDS OR THE RAJE COMPUTER EMIRATES BE LIABLE FOR
  80. ANY DAMAGES (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS
  81. INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER SUBSEQUENT LOSS) ARISING
  82. OUT OF THE USE OF, OR INABILITY TO USE THIS PROGRAM, EVEN IF ROBERT EDWARDS OR
  83. THE RAJE COMPUTER EMIRATES HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH
  84. DAMAGES.
  85.  
  86.  
  87.  
  88.  
  89.                                   TRADEMARKS
  90.  
  91. DRT is a trademark of The RaJE Computer Emirates.
  92.  
  93.  
  94.  
  95.                            !!! A NOTE ON GENDER !!!
  96.  
  97. Throughout this manual references are made to he/him/his.  I am not a sexist
  98. and struggled hard with a way to convey my point without offending a
  99. particular sex.  I couldn't.  If I tried replacing every occurrence of he with
  100. he/she and him with him/her, the text seemed to loose its point.  If you are
  101. offended by this I am sorry.  If you can come up with a better solution I
  102. would be grateful if you would pass this on to me.  Phone numbers can be found
  103. in the text of this manual.  Thank You.
  104.  
  105.  
  106.                         DOOR Registration Telethon v1.00
  107.                       Copyright (C) 1991 by Robert Edwards
  108.                            -=< ALL RIGHTS RESERVED >=-
  109.  
  110.  
  111.                               TABLE OF CONTENTS
  112.  
  113.  1.0     Introduction....................................................... 1
  114.  1.1     The Problem........................................................ 1
  115.  1.2     The Solution....................................................... 1
  116.  
  117.  2.0     DRT Files as Delivered............................................. 1
  118.  
  119.  3.0     System Requirements................................................ 3
  120.  3.1     Installing A New Version Of DRT.................................... 3
  121.  3.2     First Time Installation............................................ 3
  122.          (DRT.CTL Menu)..................................................... 4
  123.          (DRT.DAT Menu 1)................................................... 6
  124.          (DRT.DAT Menu 2)................................................... 7
  125.          (DRT.DAT Menu 3)................................................... 9
  126.  
  127.  4.0     Understanding The DRT.LOG File.....................................11
  128.  
  129.  5.0     Installing A New Telethon..........................................11
  130.  5.1     Calling An Existing Telethon.......................................11
  131.  5.1A    Batch File Call....................................................12
  132.  5.1B    SF.BAT File Call...................................................12
  133.  5.1C    Other..............................................................12
  134.  
  135.  6.0     Maintaining A Telethon.............................................13
  136.  6.1     Understanding the Lock-Out Feature.................................13
  137.  
  138.  7.0     Mouse Support......................................................14
  139.  
  140.  8.0     Tech Support.......................................................14
  141.  
  142.  9.0     Upgrades...........................................................14
  143.  
  144.  Appendix A - File Descriptions.............................................15
  145.  Appendix B - DRT Support Sites.............................................17
  146.  Appendix C - Commonly Asked Questions......................................18
  147.  
  148.  
  149.                         DOOR Registration Telethon v1.00               Page   1
  150.                       Copyright (C) 1991 by Robert Edwards
  151.                            -=< ALL RIGHTS RESERVED >=-
  152.  
  153.  
  154. 1.       INTRODUCTION:
  155.  
  156.          Whew! Ahhh, done with all that legal mumbo-jumbo.  No lets get to the
  157.          real reason you are reading this document: "What can DRT do for a
  158.          BBS?".  DRT is a program designed to help the SysOp of a computer
  159.          based Bulletin Board System (BBS) register often used Shareware by
  160.          requesting the BBS users to pledge money for a particular program.
  161.  
  162. 1.1      THE PROBLEM
  163.  
  164.          Most SysOps (You included, I hope) truly desire to register things
  165.          such as their BBS software, file transfer protocols, and online games
  166.          (DOORS).  Although very few ever do.  The cost is just overwhelming. 
  167.          Some BBS's resort to charging their users just for the access (Pay
  168.          boards).  Others request money in return for more time/options on the
  169.          board.  And the rest just run without registered software!
  170.  
  171. 1.2      THE SOLUTION
  172.  
  173.          SysOps start using DRT (DOOR Registration Telethon).  This powerful
  174.          package is used to request pledges from users on individual
  175.          programs.  Thus, if a user plays Global War(tm) every day, why
  176.          shouldn't he help pay for the registration?  With DRT, the user is
  177.          provided a tidy means of seeing why he should help register a
  178.          particular DOOR and his usage of the DOOR in relation to the other
  179.          BBS users.  Then he can choose to pledge and be provided check and
  180.          mailing instructions or just return to the DOOR.
  181.  
  182. 2.0      DRT FILES AS DELIVERED
  183.  
  184.          This version of DRT should have been delivered with the following
  185.          files:
  186.  
  187.          FILE NAME         SIZE       DATE     TIME
  188.          -------------------------------------------
  189.          ADDRESS.TXT           562  09-03-91  08:25p
  190.          BUG.RPT             2,448  09-04-91  12:17p
  191.          DRT.DOC            48,687  09-06-91  03:53p
  192.          DRT.EXE            46,640  09-03-91  08:14p
  193.          DRT.HLP             1,078  05-14-91  11:26a
  194.          DRTBOOT.80            554  09-03-91  09:15p
  195.          DRTBOOT.ANS         2,204  09-03-91  09:10p
  196.          DRTBULL.EXE         9,645  07-11-91  04:04p
  197.          ENHANCE.RPT         2,253  09-04-91  12:31p
  198.          PROD.80               582  09-05-91  04:53p
  199.          PROD.ANS              580  09-05-91  05:18p
  200.          READ.ME             1,059  09-05-91  05:52p
  201.          REGISTER.ME         4,530  09-05-91  06:08p
  202.          THANKS.TXT            583  09-05-91  04:54p
  203.  
  204.  
  205.          If any files are missing, or are of different size/date, call a RaJE
  206.          Distribution Site for the latest version.
  207.  
  208.  
  209.                         DOOR Registration Telethon v1.00               Page   2
  210.                       Copyright (C) 1991 by Robert Edwards
  211.                            -=< ALL RIGHTS RESERVED >=-
  212.  
  213.  
  214.  
  215.  
  216.                         DOOR Registration Telethon v1.00               Page   3
  217.                       Copyright (C) 1991 by Robert Edwards
  218.                            -=< ALL RIGHTS RESERVED >=-
  219.  
  220.  
  221.                                  INSTALLATION
  222.  
  223.  
  224. 3.0      SYSTEM REQUIREMENTS
  225.  
  226.          - A fully operational BBS with associated hardware/software.
  227.          - IBM PC/XT/AT(tm) or compatible.
  228.          - 200k memory.
  229.          - A fully Hayes(tm) compatible modem.
  230.          - A hard disk drive.
  231.          - A Fossil driver.
  232.  
  233. 3.1      INSTALLING A NEW VERSION OF DRT
  234.  
  235.          - As this is the first public release of DRT you are not installing a
  236.          new version.  However, if DRT is upgraded in the future just follow
  237.          the instructions included with the upgrade.
  238.  
  239. 3.2      FIRST TIME INSTALLATION
  240.  
  241.          - Make a directory for DRT.  The name is not important but we will
  242.          assume it to be 'C:\DRT'.
  243.  
  244.          - Unarchive the DRT distribution file in DRT's directory.
  245.  
  246.          - From the DOS prompt type: DRT SETUP
  247.  
  248.          - You should see the following screen:
  249.  
  250.              ****************************************************
  251.              ********************* Warning **********************
  252.              ** This program will install DRT in the current   **
  253.              ** directory and initialize all associated files. **
  254.              **                                                **
  255.              ** Is this what you REALLY want to do?            **
  256.              **                                                **
  257.              ****************************************************
  258.              ****************************************************
  259.  
  260.          - Type: Y
  261.  
  262.          - DRT will create a few files it needs and then display the 'EDIT
  263.          CONTROL FILE' menu.  It looks like this:
  264.  
  265.  
  266.                         DOOR Registration Telethon v1.00               Page   4
  267.                       Copyright (C) 1991 by Robert Edwards
  268.                            -=< ALL RIGHTS RESERVED >=-
  269.  
  270.  
  271. DOOR Registration Telethon (DRT) Setup Version 1.0
  272. ************************* Edit Control File (DRT.CTL) ************************
  273. * (A) [            ] - Registration Code                 File Version:  1.0
  274. * (B) [Robert              ] [Edwards             ] - SysOps Name
  275. * (C) [The Force! Demon-Sion BBS               ] - BBS Name
  276. * (D) [  3] - Start requesting money on this call
  277. * (E) [    0] - Locked Baud Rate: 0 if none
  278. * (F) [  1] / [ 20] - Smallest / Highest dollar amounts to accept
  279. * (G) [C:\BBS\BULLS                            ] - Full path for bulletins
  280. * (H) [DRT.ANS     ] / [DRT.80      ] - Ansi / Ascii DRT bulletins
  281. * (I) [Prod.ANS    ] / [Prod.80     ] - Ansi / Ascii Prod Screen file name
  282. * (J) [DRTBOOT.ANS ] / [DRTBOOT.80  ] - Ansi / Ascii Boot-Off Screens
  283. * (K) [ 30] - Days after pledge to lock user out for non-payment
  284. * (L) [C:\BBS\DATA                             ] - Full path for DOOR files
  285. * (M) [FALSE] - Enable Lock-Out option?
  286. *
  287. * >----------------------=< Martha Comment Controls >=-----------------------<
  288. *
  289. * (N) 3-Look Martha! They're back!  Maybe they like it
  290. * (O) 6-Martha, I know they like it. Maybe they'll help pay for it.
  291. * (P) 9-Hey, as much as you use it, help pay for it!!!
  292. *
  293. * Press desired key, or X to end.
  294. *                 Press Z to abort.
  295. ******************************************************************************
  296.  
  297.          - Arggghhhh! You say.  It's not as bad as it looks.  DRT is very
  298.          powerful and thus requires a lot of options.  Lets break each of the
  299.          above lines down to make it easy:
  300.  
  301.          (A) - This is where you will place your registration code when your
  302.          register DRT (You are planning on registering it, right?).  The File
  303.          Version info is to allow compatibility of DRT.CTL file during
  304.          upgrades.
  305.  
  306.          (B) - SysOps Name.  Your first and last name go here.
  307.  
  308.          (C) - BBS Name.  Your BBS's name.
  309.  
  310.          (D) - Start requesting money on this call.  This is the number of
  311.          times a user must enter a DOOR before a request for a pledge is
  312.          made.  DRT keeps track of the number of times each user has accessed
  313.          each DOOR.  Too low of a value here may discourage your users from
  314.          trying new DOORs.  Too high of a number may make it difficult to
  315.          register your DOORs.
  316.  
  317.          (E) - Locked baud rate.  If you do not lock your comm port (Required
  318.          for most high speed modems) enter a 0 here, otherwise enter the speed
  319.          at which the comm port is locked.
  320.  
  321.          (F) - Smallest / Highest dollar amounts to accept.  This sets your
  322.          limits for pledges.  When a user decides to pledge he will be given a
  323.          choice of 10 dollar amounts ranging between the two values entered 
  324.  
  325.                         DOOR Registration Telethon v1.00               Page   5
  326.                       Copyright (C) 1991 by Robert Edwards
  327.                            -=< ALL RIGHTS RESERVED >=-
  328.  
  329.          here.  The lower number must be in a range of 1 - 5 while the larger
  330.          number must be greater than 15.  Be realistic in your expectations
  331.          for pledges.
  332.  
  333.          (G) - Full path for bulletins.  This is where the DRT Bulletins
  334.          created by DRTBULL.EXE will be placed.  Even if you do not plan on
  335.          using bulletins a valid pathname must be entered.
  336.  
  337.          (H) - Ansi / Ascii DRT bulletins.  The name of the ANSI/ASCII
  338.          Bulletins created by DRTBULL.EXE.  You MUST enter valid filenames.
  339.  
  340.          (I) - Ansi / Ascii Prod Screen file name.  The name of the prod
  341.          screens to be displayed to users (Explained later).  You MUST enter
  342.          valid filenames.
  343.  
  344.          (J) - Ansi / Ascii Boot-Off Screens.  Screen to be displayed before
  345.          booting someone off (Explained later).  You MUST enter valid
  346.          filenames.
  347.  
  348.          (K) - Days after pledge to lock user out for non-payment.
  349.  
  350.          (L) - Full path for DOOR files.  Tells DRT where to find the
  351.          DORINFO1.DEF / DOOR.SYS / PCBOARD.SYS / CALLINFO.BBS files (Depending
  352.          on the command line).  Example: C:\BBS\DATA
  353.  
  354.          (M) - Enable Lock-Out option?  Tells DRT to enable the lock-out
  355.          features (Explained later).
  356.  
  357.          (N) / (O) / (P) - The dreaded Martha Comments.  A humorous feature of
  358.          DRT allows the uses of the newly coined term 'Martha Comments'.  Up
  359.          to three comments are allowed.  The number represents the call to
  360.          start posting the message.  Only one comment will be displayed per
  361.          call.
  362.  
  363.          (X) - Exits this menu and saves data in the DRT.CTL file.
  364.  
  365.          (Z) - Aborts the edit session WITHOUT saving the new data.
  366.  
  367.     Understand?  Modify the parameters as you see fit.  Don't worry about
  368. making mistakes because DRT will check most of these BEFORE you are allowed to
  369. exit this menu.  And secondly, you can easily modify the parameters at any
  370. time with the 'DRT MAINT' command line.
  371.  
  372.          - Now on to the next menu:  EDIT DRT DATA FILE.  It looks like this:
  373.  
  374.  
  375.                         DOOR Registration Telethon v1.00               Page   6
  376.                       Copyright (C) 1991 by Robert Edwards
  377.                            -=< ALL RIGHTS RESERVED >=-
  378.  
  379. DOOR Registration Telethon (DRT) Setup Version 1.0
  380. ************************* Edit DRT data File (DRT.DAT) ***********************
  381. **     Short    * Long Name                                * Status          *
  382. ******************************************************************************
  383. ** A * DRT      * DOOR Registration Telethon               * Under Evaluation*
  384. ** B *          *                                          * Unused Record   *
  385. ** C *          *                                          * Unused Record   *
  386. ** D *          *                                          * Unused Record   *
  387. ** E *          *                                          * Unused Record   *
  388. ** F *          *                                          * Unused Record   *
  389. ** G *          *                                          * Unused Record   *
  390. ** H *          *                                          * Unused Record   *
  391. ** I *          *                                          * Unused Record   *
  392. ** J *          *                                          * Unused Record   *
  393. ** K *          *                                          * Unused Record   *
  394. ** L *          *                                          * Unused Record   *
  395. ** M *          *                                          * Unused Record   *
  396. ** N *          *                                          * Unused Record   *
  397. ** O *          *                                          * Unused Record   *
  398. ******************************************************************************
  399. *                               Page 1 of 4
  400. * Press desired key, or X to end.
  401. *               Press Pg-Up /
  402. *                     Pg-Dn for other pages.
  403. ******************************************************************************
  404.  
  405.          - Arggghhhh! Again rings in the air.  And again, it's not as bad as
  406.          it looks.  As a matter-of-fact, this menu is MUCH easier than the
  407.          previous one.  DRT currently supports concurrent telethons for 50
  408.          DOORS (DRT itself uses 1 record so the SysOp may run 49 telethons). 
  409.          Only 15 DOOR summaries are displayed at once (use the page-up &
  410.          page-down keys for additional DOORs).  Keys A - O select the display
  411.          of a specific DOORs telethon.  Let's break down the columns:
  412.  
  413.          SHORT - This is the short name for the DOOR telethon.
  414.  
  415.          LONG NAME - The complete name of the DOOR to be registered.
  416.  
  417.          CURRENT STATUS - Registered, Awaiting Pledges etc.
  418.  
  419.  
  420.          - To start a telethon or modify a currently running telethon press
  421.          the appropriate key (A - O).  The following menu will then be
  422.          displayed (Yes, another one):
  423.  
  424.  
  425.                         DOOR Registration Telethon v1.00               Page   7
  426.                       Copyright (C) 1991 by Robert Edwards
  427.                            -=< ALL RIGHTS RESERVED >=-
  428.  
  429.  
  430. DOOR Registration Telethon (DRT) Setup Version 1.0
  431. ************************* Edit DRT data File (DRT.DAT) ***********************
  432. *
  433. * Record  2 of 50                  Status: Unused Record
  434. *
  435. * (A) [        ] - Short DOOR name (Must qualify as a filename prefix)
  436. * (B) [                                        ] - Long DOOR name
  437. * (C) [    0] - Registration fee
  438. *     [    0] - Total Pledged
  439. * (D) [    0] - Total collected
  440. *     [    0] - DOOR usage
  441. *     [08/06/1991, 22:14:48] - Date/Time this DOORs Telethon started
  442. *     [08/06/1991, 22:14:48] - Date/Time of last call to this DOOR
  443. * (R) [Mark this DOOR as registered]
  444. *
  445. * >=-----------------------=< Reasons to Register >=------------------------=<
  446. * (E) [                                                                      ]
  447. * (F) [                                                                      ]
  448. * (G) [                                                                      ]
  449. * (H) [                                                                      ]
  450. * (I) [                                                                      ]
  451. *
  452. * Press desired key, or X to end.
  453. *
  454. ******************************************************************************
  455.  
  456.          - Arggghhhh!  Please! Come up with another distress call.  And once
  457.          again it isn't that bad.  You know the routine:
  458.  
  459.          (A) - Short DOOR name (Must qualify as a filename prefix).  The data
  460.          for this telethon will be stored in a file named xxxxxxxx.DAT (Where
  461.          xxxxxxxx = whatever you define as the short name).  That is why the
  462.          short name must qualify as a filename prefix.  Example:  If you are
  463.          running a telethon to register Global War(tm), make the short name
  464.          'GWAR'.  Then the data file for Global War's telethon will be named
  465.          'GWAR.DAT'.  Understand?
  466.  
  467.          (B) - Long DOOR name.  Just what is says.  If we use the previous
  468.          example the long name would be 'Global War'.
  469.  
  470.          (C) - Registration fee.  The fee to register the DOOR in whole
  471.          dollars.  If the cost is $25.00 then enter 25.
  472.  
  473.          (D) - Total collected.  Use this option to mark users as paid. 
  474.          Another menu will be displayed (An example follows in a few lines).
  475.  
  476.          (R) - Mark this DOOR as registered.  Use this to tell DRT that you
  477.          have received your registration for this DOORs telethon.
  478.  
  479.          (E) / (F) / (G) / (H) / (I) - Enter some of the reasons the DOOR
  480.          author gives to register this DOOR.  THESE OPTIONS ARE VERY VERY
  481.          IMPORTANT!!!  If you expect your users to fork over some of their
  482.          hard earned money you need to provided them with sound reasons to do
  483.          so.
  484.  
  485.  
  486.                         DOOR Registration Telethon v1.00               Page   8
  487.                       Copyright (C) 1991 by Robert Edwards
  488.                            -=< ALL RIGHTS RESERVED >=-
  489.  
  490.  
  491.     In almost all DOOR documentation you will find the perks and incentives to
  492. register the DOOR.  Place the key ones here.  If you are trying to register a
  493. DOOR that offers nothing for registration try putting things like 'Because you
  494. are still using this DOOR' etc.
  495.  
  496.          - When your friendly mailman brings you some pledges, you will enter
  497.          into this menu (for the DOOR you received the pledges) and type the
  498.          letter D (Total Collected).  And poof! Another menu:
  499.  
  500.  
  501.                         DOOR Registration Telethon v1.00               Page   9
  502.                       Copyright (C) 1991 by Robert Edwards
  503.                            -=< ALL RIGHTS RESERVED >=-
  504.  
  505.  
  506. DOOR Registration Telethon (DRT) Setup Version 1.0
  507. ************************* Edit DRT data File (DRT.DAT) ***********************
  508. *   *                          * # of* Date of  *  Total  *  Date of *  Total
  509. *   * Username (First 25 chars)*Calls*Last Call * Pledged *  Pledge  *  Paid
  510. *   **************************************************************************
  511. * A * Robert Edwards           *    0*08/06/1991*         *          *
  512. * B *                          *     *          *         *          *
  513. * C *                          *     *          *         *          *
  514. * D *                          *     *          *         *          *
  515. * E *                          *     *          *         *          *
  516. * F *                          *     *          *         *          *
  517. * G *                          *     *          *         *          *
  518. * H *                          *     *          *         *          *
  519. * I *                          *     *          *         *          *
  520. * J *                          *     *          *         *          *
  521. * K *                          *     *          *         *          *
  522. * L *                          *     *          *         *          *
  523. * M *                          *     *          *         *          *
  524. * N *                          *     *          *         *          *
  525. * O *                          *     *          *         *          *
  526. *   **************************************************************************
  527. * Press desired key, or X to end.    Page 1 of 7
  528. *               Press Pg-Up /
  529. *                     Pg-Dn for other pages.
  530. ******************************************************************************
  531.  
  532.          Uggghhh!  That's better, I was getting tired of "Arggghhhh!".  And
  533.          once again it is very simple:
  534.  
  535.          (A - O) - User.  The SysOp is automatically enrolled in EVERY
  536.          telethon.  The rest of the space (99) is used to record online user
  537.          status.  Select the appropriate key to log payment (A small menu will
  538.          be displayed asking how much was received).  Each of the columns are
  539.          self-explanatory but... We will go over them just in case:
  540.  
  541.          USERNAME - The users name as reported by the DOORFILE (IE: DOOR.SYS,
  542.          DORINFO1.DEF, PCBOARD.SYS, or CALLINFO.BBS).  If the users name is
  543.          longer than 25 characters, only the first 25 will be displayed.
  544.  
  545.          # OF CALLS - Total number of times the user has accessed "THIS"
  546.          telethon.  NOT the number of times he has called your board!
  547.  
  548.          DATE OF LAST CALL - Just that, the date that the user last accessed
  549.          "THIS" telethon.  NOT the last time he called your board!
  550.  
  551.          TOTAL PLEDGED - Amount the user has pledged to "THIS" telethon.
  552.  
  553.          DATE OF PLEDGE - The date the user made a pledge (Used in conjunction
  554.          with the Lock-Out feature).
  555.  
  556.          TOTAL PAID - The amount of money you have received from the user for
  557.          "THIS" telethon.
  558.  
  559.  
  560.  
  561.                         DOOR Registration Telethon v1.00               Page  10
  562.                       Copyright (C) 1991 by Robert Edwards
  563.                            -=< ALL RIGHTS RESERVED >=-
  564.  
  565.               >>>>>>>>>>    A NOTE ABOUT COLORS      <<<<<<<<<<
  566.               The users are color coded for your convenience:
  567.  
  568.               - GREEN = User has not yet been asked to pledge money
  569.               (controlled by CALL TO BUG ON variable in the DRT.CTL menu).
  570.  
  571.               - RED = User has been asked to pledge money but has not yet made
  572.               a pledge.
  573.  
  574.               - YELLOW = User has pledged money but has not yet paid.
  575.  
  576.               - BLUE = User has pledged and paid!
  577. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>--<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  578.  
  579.  
  580.          - Now that you have seen all the menus, and should have DRT somewhat
  581.          configured for you system we still need to do a couple of things.
  582.  
  583.          - With a text editor modify the file 'ADDRESS.TXT' to contain check
  584.          and mailing instructions.  This file will be displayed to the user
  585.          when a pledge is made.  DO NOT SKIP THIS STEP!  If you do, the users
  586.          will be given my name and address.  I won't complain if people start
  587.          sending me money, nor will I be held liable.
  588.  
  589.          - Don't forget to register this DOOR.  It has been VERY successful on
  590.          both of the RaJE boards (Force! Demon-Sion & Middle Earth) during
  591.          Beta testing.  You will be surprised on how quickly your users are to
  592.          give up a buck or two if they are provided a very tidy and formatted
  593.          way to do so.  It is time to register DRT if you have any success
  594.          with it at all.
  595.  
  596.          - You can now start each of your telethons at your leisure.  Chapter
  597.          5 describes procedures required to do this.
  598.  
  599.  
  600.  
  601.                         DOOR Registration Telethon v1.00               Page  11
  602.                       Copyright (C) 1991 by Robert Edwards
  603.                            -=< ALL RIGHTS RESERVED >=-
  604.  
  605.  
  606. 4.0      UNDERSTANDING THE DRT.LOG FILE
  607.  
  608.          - The DRT.LOG file provides the SysOp with information pertaining to
  609.          the functioning of DRT.  It was modeled after FORCE!(tm) BBS log
  610.          file:
  611.  
  612. *****************************************************************************
  613. Command  : DRT ac dorinfo1.def
  614. DOOR     : Alpha Colony 6                                      (Usage:    86)
  615. User     : Bob Specyalski                                      (Usage:    11)
  616. Called on: Sunday, 9/1/1991 * 14:14:01
  617. Remind   : User reminded of $3.00 Pledge made 9 Days ago.
  618. Executed : Exit.................................................. AT 14:14:29
  619. *****************************************************************************
  620.  
  621.     - COMMAND = The command your batch file used to call DRT.
  622.  
  623.     - DOOR = Long name of the DOOR to register and number of times this DOOR
  624.     has been used since the telethon started.
  625.  
  626.     - USER = User name as reported by DOORFILE (IE: DOOR.SYS, DORINFO1.DEF,
  627.     PCBOARD.SYS, or CALLINFO.BBS) and the number of times the user has
  628.     accessed this DOOR since the telethon started.
  629.  
  630.     - CALLED ON = Date and time of this access.
  631.  
  632.     - Various: other entries to let you know what the user did (IE: View other
  633. pledges, view DRT status, Pledge, Reminded of Pledge, Thanked for Pledge,
  634. etc...)
  635.  
  636. 5.0      INSTALLING A NEW TELETHON
  637.  
  638.          - You must have completed the FIRST TIME INSTALLATION STEP.
  639.  
  640.          - Run the maint option of DRT (Type:  DRT MAINT)
  641.  
  642.          - Select option  "(D) [Edit Data File(s)]".  This will bring you to
  643.          the EDIT DRT DATA FILES menu.
  644.  
  645.          - Select a free (unused) record.
  646.  
  647.          - You MUST fill in options A-C (DOOR long name/Short name and
  648.          Registration FEE).  Options E-I can be used to tell the user the
  649.          benefits of registering this DOOR (Highly recommended!  Tell the user
  650.          what they get for registering and they are more likely to pledge and
  651.          pay).  In depth explanation of these options can be found within
  652.          chapter 3.2.
  653.  
  654.          -  Now that DRT knows all it needs to about your DOOR, you have to
  655.          call it PRIOR to loading your DOOR.  This is explained in the next
  656.          chapter.
  657.  
  658. 5.1      CALLING AN EXISTING TELETHON
  659.  
  660.  
  661.  
  662.                         DOOR Registration Telethon v1.00               Page  12
  663.                       Copyright (C) 1991 by Robert Edwards
  664.                            -=< ALL RIGHTS RESERVED >=-
  665.  
  666.          - You must have completed the INSTALLING A NEW TELETHON step.
  667.  
  668.          A.  BATCH FILE CALL
  669.  
  670.               - This is the recommended way to call DRT.  The reason:  This is
  671.               how my BBS runs and thus, how DRT was designed.
  672.  
  673.               - With a text editor, edit your batch file for the DOOR.  You
  674.               will insert the following lines BEFORE the call to the DOOR.  I
  675.               will use my Global War(tm) batch file as an example:
  676.  
  677.               * BEFORE *
  678.  
  679.     Echo off
  680.     REM WAR.BAT for Global War.  Uses DORINFO1.DEF (Force! Option E)
  681.     C:
  682.     cd\Doors\Gwar
  683.     WAR /R E:\BBS\DATA\DORINFO1.DEF
  684.  
  685.               * AFTER *
  686.  
  687.     Echo off
  688.     REM WAR.BAT for Global War.  Uses DORINFO1.DEF (Force! Option E)
  689.     REM Call DRT telethon for Global War
  690.     E:
  691.     CD\BBS\UTIL\DRT
  692.     DRT Gwar Dorinfo1.def
  693.     REM DRT complete, now call Global War
  694.     C:
  695.     cd\Doors\Gwar
  696.     WAR /R E:\BBS\DATA\DORINFO1.DEF
  697.  
  698.               - The REM lines are remarks and are not needed.  Notice that the
  699.               first thing you do is change to the DRIVE and DIRECTORY that
  700.               contains DRT.
  701.  
  702.               - Next, call DRT with the following convention:
  703.  
  704.                    DRT [Door Short Name] [DOORFILE name]
  705.  
  706.               - In the above example, I used Gwar as a short name for Global
  707.               War (In the DRT data file), and I am telling DRT to look for the
  708.               DORINFO1.DEF file (The path for the DORINFO1.DEF file is
  709.               contained in the DRT.CTL file.  Refer to chapter 3.2)
  710.  
  711.          B.  SF.BAT FILE CALL
  712.  
  713.               - Identical to the above example except all DOOR calls are
  714.               contained in the SF.BAT file.
  715.  
  716.          C.  OTHER
  717.  
  718.               - I just don't know.  If your BBS does not support batch file
  719.               calls you will need somehow to change DRIVE and DIRECTORY to the
  720.               
  721.  
  722.                         DOOR Registration Telethon v1.00               Page  13
  723.                       Copyright (C) 1991 by Robert Edwards
  724.                            -=< ALL RIGHTS RESERVED >=-
  725.  
  726.               DRT directory and then call DRT as in the above examples.  I
  727.               will be glad to assist in the installation of DRT for these type
  728.               of BBS's.  Just call my board and leave a message explaining the
  729.               Name of your BBS software and how it calls DOORS.  Once we get
  730.               you up and running I will include this information in the future
  731.               DRT documentation.
  732.  
  733. 6.0      MAINTAINING A TELETHON
  734.  
  735.          - You should already be able to maintain a telethon.  Here are a few
  736.          key point to remember:
  737.  
  738.          (A) COLLECTING MONEY:  When you receive money from your users be sure
  739.          to mark the user as paid (reference chapter 3.2).  This will update
  740.          the telethon status but, more importantly, the next time the user
  741.          access the DOOR, they will be thanked for their payment and sent
  742.          directly into the DOOR.
  743.  
  744.          (B) MARKING A DOOR AS REGISTERED:  When you receive the registration
  745.          for the DOOR, be sure to mark it is registered in the DRT data files
  746.          (Reference chapter 3.2).  This will show the DOOR as registered when
  747.          the user requests DRT status or when bulletins are made with the
  748.          DRTBULL.EXE utility.  Be sure to normalize your BATCH file.  Reverse
  749.          the procedures used in chapter 5.1.
  750.  
  751.          (C) GENERATING REPORTS:  Several reports can be generated (Screen
  752.          and/or file) to display DRT's status.  Browse through these, you may
  753.          find some of them quite useful.
  754.  
  755.  6.1     UNDERSTANDING THE LOCK-OUT FEATURE
  756.  
  757.          - DRT has a powerful function:  LOCK-OUT.  We will discus the finer
  758.          points of this feature.
  759.  
  760.          Lock-Out is controlled by several factors: 1) Do you have Lock-Out
  761. enabled?  2) Lock-Out days.  3) How many days ago did the user pledge but
  762. still hasn't paid?
  763.  
  764.          A lock-out condition is described as:  "A user made a pledge and has
  765. not yet paid AND that pledge was made more than Lock-out-Days ago". 
  766. Confused?  Lock-out-Days is controlled in the DRT.CTL menu.  If the number of
  767. days a pledge has been unpaid is greater than Lock-out-days the user is in a
  768. lock-out condition.
  769.  
  770.          If you have lock-out enabled in the DRT.CTL menu, the user will be
  771. displayed the file 'DRTBOOT.ANS' or 'DRTBOOT.80' (Ansi or non-ansi user). 
  772. Then he will be unceremoniously booted off of your BBS.  (In order for this to
  773. work properly your modem must be fully Hayes compatible, a more forgiving
  774. interface is being designed for v2.0).
  775.  
  776.          If you do not have lock-out enabled, the user will be told that he
  777. could be locked out at any time with a strong recommendation to pay the pledge
  778. quickly.
  779.  
  780.  
  781.  
  782.                         DOOR Registration Telethon v1.00               Page  14
  783.                       Copyright (C) 1991 by Robert Edwards
  784.                            -=< ALL RIGHTS RESERVED >=-
  785.  
  786.          If the user is within 15 days of a possible lock-out condition, he
  787. will be displayed the file 'PROD.ANS' or 'PROD.80' (Ansi or non-ansi user).
  788.  
  789.          You are free to be as creative with the Boot and Prod screens as you
  790. like, so have fun.
  791.  
  792.          One final note.  If you do not wish to have anything to do with the
  793. lock-out feature or the prodding feature, set the Lock-out-days to 255.
  794.  
  795. 7.0      MOUSE SUPPORT
  796.  
  797.          - DRT is designed to utilize a MicroSoft Compatible mouse in the
  798.          setup and maint routines.  It will auto-sense the existence of the
  799.          mouse driver and use it if present.  Mouse usage is quite simple. 
  800.          Click the mouse on the LINE of the choice you desire.  YOU DO NOT
  801.          NEED TO BE OVER THE KEY YOU WISH.  Just on the same line.  Both mouse
  802.          buttons function the same.
  803.  
  804. 8.0      TECH SUPPORT
  805.  
  806.          - Tech support is extended to both registered and non-registered
  807.          users for installation assistance and bug reports.
  808.  
  809.          - Enhancement requests are accepted from only registered users.
  810.  
  811.          - Fill out the appropriate form (BUG.RPT or ENHANCE.RPT) and mail to
  812.          a DRT support site.
  813.  
  814.          - An online BUG and ENHANCEMENT reporting system will be in place by
  815.          December 1991.  To access this call a DRT support board.
  816.  
  817. 9.0      - UPGRADES
  818.  
  819.          - DRT will be upgraded as needed.  Work on version 2.0 has already
  820.          begun.  This will be a complete rewrite conforming to Object Oriented
  821.          Programming standards.  The look and feel of the SysOp maint portion
  822.          will be greatly enhanced.  The price of version 2.0 will increase
  823.          slightly to compensate for the extra effort and man hours involved. 
  824.          REGISTRATION CODES FOR VERSION 1.0 WILL WORK WITH ALL FUTURE VERSION
  825.          AND THUS THE UPGRADE WILL BE FREE.
  826.  
  827.  
  828.                         DOOR Registration Telethon v1.00               Page  15
  829.                       Copyright (C) 1991 by Robert Edwards
  830.                            -=< ALL RIGHTS RESERVED >=-
  831.  
  832.                                   APPENDIX A
  833.                               FILE DESCRIPTIONS
  834.  
  835. The following is a brief description of files that are contained in the DRT
  836. distribution archive OR are created by DRT:
  837.  
  838.     ADDRESS.TXT -  Address file.  This file should contain check and mailing
  839.                    instructions for your users.  YOU NEED TO EDIT THIS FILE TO
  840.                    REFLECT YOUR NAME AND ADDRESS.  IF THIS FILE DOES NOT EXIST
  841.                    THE USER WILL BE GIVEN THE DRT SUPPORT BOARD ADDRESS!
  842.  
  843.     BUG.RPT -      DRT bug report form.  If you encounter a bug in DRT, fill
  844.                    this form out and mail it to a DRT support site.  This file
  845.                    IS NOT required for DRT to execute.
  846.  
  847.     DRT.CTL -      DRT control file.  This file contains information you have
  848.                    provided for DRT to execute (Created during DRT SETUP). 
  849.                    This file IS required for DRT to execute.
  850.  
  851.     DRT.DAT -      DRT data file.  This file contains general information you
  852.                    have entered pertaining to each telethon (Created during
  853.                    DRT SETUP).  This file IS required for DRT to execute.
  854.  
  855.     DRT.DOC -      DRT SysOps Manual.  Your reading it even as we speak!  This
  856.                    file IS NOT required for DRT to execute.
  857.  
  858.     DRT.ERR -      DRT error file.  Created when DRT encounters an unexpected
  859.                    error.  The contents of this file are used to fill out the
  860.                    BUG.RPT report.  NOTE:  An error code of 1 is generated
  861.                    when a user is locked out.  This file IS NOT required for
  862.                    DRT to execute.
  863.  
  864.     DRT.EXE -      DRT executable file.  This is the DRT program.  This file
  865.                    IS required for DRT to execute.
  866.  
  867.     DRT.HLP -      Text file displayed when user requests online help.  This
  868.                    file is delivered containing only a brief description of
  869.                    the shareware concept.  You may modify this file to fit
  870.                    your needs.  This file IS NOT required for DRT to execute.
  871.  
  872.     DRT.LOG -      DRT log file.  This file contains useful information about
  873.                    each users DRT session (Created or appended upon each DRT
  874.                    activation).  If this file grows to big, just delete it. 
  875.                    It will be recreated at the next DRT execution.  This file
  876.                    IS NOT required for DRT to execute.
  877.  
  878.     DRT.WRD -      DRT word file.  This file is for a future release and
  879.                    contains no data (Created during DRT SETUP).  This file IS
  880.                    NOT required for DRT to execute.
  881.  
  882.     DRTBOOT.80 -   ASCII file displayed when a NON-ANSI user is locked out. 
  883.                    File name is configurable in the DRT.CTL menu.  You may
  884.                    modify this file to fit your needs.  This file IS NOT
  885.                    required for DRT to execute.
  886.  
  887.  
  888.                         DOOR Registration Telethon v1.00               Page  16
  889.                       Copyright (C) 1991 by Robert Edwards
  890.                            -=< ALL RIGHTS RESERVED >=-
  891.  
  892.  
  893.     DRTBOOT.ANS -  Ansi file displayed when an ANSI user is locked out.  File
  894.                    name is configurable in the DRT.CTL menu.  You may modify
  895.                    this file to fit your needs.  This file IS NOT required for
  896.                    DRT to execute.
  897.  
  898.     DRTBULL.EXE -  DRTBULL executable file.  This is the DRTBULL program. 
  899.                    Only required if you wish to generate bulletins for DRT. 
  900.                    This file IS NOT required for DRT to execute.
  901.  
  902.     ENHANCE.RPT -  DRT enhancement request.  If you are a registered user of
  903.                    DRT and want to suggest an enhancement, fill this form out
  904.                    and mail it to a DRT support board.  This file IS NOT
  905.                    required for DRT to execute.
  906.  
  907.     PROD.80 -      ASCII file displayed when a non-ANSI user is within 15 days
  908.                    of a possible lock-out condition.  File name is
  909.                    configurable in the DRT.CTL menu.  This file IS NOT
  910.                    required for DRT to execute.
  911.  
  912.     PROD.ANS -     ANSI file displayed when an ANSI user is within 15 days of
  913.                    a possible lock-out condition.  File name is configurable
  914.                    in the DRT.CTL menu.  This file IS NOT required for DRT to
  915.                    execute.
  916.  
  917.     READ.ME -      Text file containing any last minute changes and
  918.                    rudimentary instructions.
  919.  
  920.     REGISTER.ME -  DRT registration form.  To register DRT, fill this form out
  921.                    and mail it to the address indicated on the form.  This
  922.                    file IS NOT required for DRT to execute.
  923.  
  924.     REPORT.DRT -   DRT report file.  Created or appended to by the report
  925.                    functions in DRT MAINT.  This file IS NOT required for DRT
  926.                    to execute.
  927.  
  928.     THANKS.TXT -   Thank you file.  This file contains your personal thank you
  929.                    to the user for paying their pledge.  If this file does not
  930.                    exist the user will be give a 2 line thank you.  This file
  931.                    IS NOT required for DRT to execute.
  932.  
  933.     ????????.DAT - These files vary.  The prefix of the file name is the short
  934.                    name of the telethon (DOOR to register).  These files
  935.                    contain critical user information for the telethon.  These
  936.                    files ARE required for DRT to execute.
  937.  
  938.  
  939.  
  940.                         DOOR Registration Telethon v1.00               Page  17
  941.                       Copyright (C) 1991 by Robert Edwards
  942.                            -=< ALL RIGHTS RESERVED >=-
  943.  
  944.                                   APPENDIX B
  945.                               DRT SUPPORT SITES
  946.  
  947.   ---===<<< ********** ********** ********** ********** ********** >>>===---
  948.  
  949.        The Force! Demon-Sion BBS (Birth site of RaJE Computer Emirates)
  950.                                 1(207)963-2683
  951.        US ROBOTICS HST 14400 (300/1200/2400/4800/7200/9600/12000/14400)
  952.                             SysOp: Robert Edwards
  953.                                  NSGA # 6725
  954.                            WINTER HARBOR, ME 04693
  955.  
  956.   ---===<<< ********** ********** ********** ********** ********** >>>===---
  957.  
  958.                Middle Earth (Co-Home of RaJE Computer Emirates)
  959.                                 1(915)520-2112
  960.                                 300/1200/2400
  961.                              SysOp: James Edwards
  962.                                Apartment # 1007
  963.                            5266 West Loop 250 North
  964.                               Midland, TX 79707
  965.  
  966.   ---===<<< ********** ********** ********** ********** ********** >>>===---
  967.  
  968.  
  969.  
  970.                         DOOR Registration Telethon v1.00               Page  18
  971.                       Copyright (C) 1991 by Robert Edwards
  972.                            -=< ALL RIGHTS RESERVED >=-
  973.  
  974.                                   APPENDIX C
  975.                            COMMONLY ASKED QUESTIONS
  976.  
  977. Q.  When a user makes a pledge, they are displayed the wrong check and mailing
  978.     instruction.  Why?
  979.  
  980.     A.   You need to either modify or create a file called "ADDRESS.TXT" in
  981.          your DRT directory.  This file should contain your check and mailing
  982.          instructions.
  983.  
  984. Q.  I have been running DRT for several weeks and have received no pledges. 
  985.     Am I doing something wrong?
  986.  
  987.     A.   Maybe.  First, is DRT activating before the user enters the DOOR.  If
  988.          not refer to the chapter on CALLING A TELETHON.  If your users are
  989.          just refusing to pledge I would look at two other items.  1) Did you
  990.          configure the Telethon with Reasons To Register?  If you provide the
  991.          users with the benefits of helping register the DOOR they are
  992.          inclined to do so.  2) Did you set the acceptable pledges
  993.          unrealistically?  If so, bring them down.
  994.  
  995. Q.  I don't understand the calling convention:  
  996.                        DRT [DOOR Short Name] [DOORFILE]
  997.  
  998.     A.   DOOR Short Name is the short name you gave the telethon in the
  999.          DRT.DAT menu.  DOORFILE can be:  DOOR.SYS, DORINFO1.DEF,
  1000.          CALLINFO.BBS, PCBOARD.SYS.  If your BBS does not support one of these
  1001.          standards you must use a DOOR file converter.  Several are available
  1002.          in the share ware market.
  1003.  
  1004. Q.  What do you mean by DOORFILE path?
  1005.  
  1006.     A.   DRT needs to know where your BBS places the DOORFILE (DOOR.SYS,
  1007.          DORINFO1.DEF, CALLINFO.BBS, PCBOARD.SYS).  DOORFILE path is simple
  1008.          the directory that your BBS places these files when they are created.
  1009.  
  1010. Q.  I am running a telethon for 2 DOORs.  GWAR needs a DORINFO1.DEF and
  1011.     HANGMAN needs a PCBOARD.SYS.  Do I need to somehow convert all my DOORs to
  1012.     use one DOORFILE type?
  1013.  
  1014.     A.   NO!  Each and every time you activate DRT it can use a different
  1015.          DOORFILE.  That is why you must specify the DOORFILE type on the
  1016.          command line.  Just use separate command lines:
  1017.                             DRT Gwar Dorinfo1.def
  1018.                            DRT Hangman PCboard.sys
  1019.  
  1020. Q.  DRT thinks John Smith is online when Joe Blow really is.  Why?
  1021.  
  1022.     A.   Most probably you have told DRT the wrong DOORFILE type.  You must
  1023.          specify the DOORFILE that was just created for the DOOR the user was
  1024.          trying to go into.  Review both your batch file.
  1025.  
  1026. Q.  I have found what I think is a bug in DRT.  What should I do?
  1027.  
  1028.  
  1029.  
  1030.                         DOOR Registration Telethon v1.00               Page  19
  1031.                       Copyright (C) 1991 by Robert Edwards
  1032.                            -=< ALL RIGHTS RESERVED >=-
  1033.  
  1034.     A.   1) Write down the date and time of the bug.
  1035.          2) Write down the date and time of the file DRT.ERR (If it exists).
  1036.          3) View the file DRT.ERR (If it exists) and write down its contents.
  1037.          4) Archive (PKZIP, LHARC, etc) or save to a floppy the following
  1038.          files:
  1039.               *.DAT
  1040.               DRT.CTL
  1041.               DRT.ERR (If it exists)
  1042.          5) Fill out the DRT Bug Report (BUG.RPT) file and mail to a DRT
  1043.          support site.  (An online bug reporting system should be in place by
  1044.          December 1991).
  1045.  
  1046. Q.  My BBS does not require the use of a Fossil driver.  Can I still use DRT?
  1047.  
  1048.     A.   Yes, but...  DRT needs to access the Fossil.  Obtain a Fossil driver
  1049.          (BNU, X00, or any other standard Fossil) and install it on your
  1050.          computer.  If your BBS doesn't need a Fossil it will ignore it but
  1051.          this will allow DRT to access the Fossil.
  1052.  
  1053. Q.  I installed a telethon and have decided to remove it.  How can I do this?
  1054.  
  1055.     A.   DRT was designed to provide as much user confidence in the SysOp as
  1056.          possible.  Therefore, removal of a telethon after it starts could
  1057.          lead to shaky practices by some (not you) unethical SysOps.  Third
  1058.          stage review of DRT identified that we were a little off of the mark
  1059.          on this point and a little back tracking is required.  Work has begun
  1060.          on a comprehensive editor to allow the removal of telethons or users
  1061.          from the data files.  We look for this utility to be available late
  1062.          '91 or early '92.  A valid DRT registration code is required for its
  1063.          use.
  1064.  
  1065. Q.  I just wanted to tell you that DRT has helped me register 95% of all my
  1066.     DOORs and I am looking forward to v2.0.  Can I be a beta test site?
  1067.  
  1068.     A.   Thanks!  (My brother asked that question by the way)  I will be
  1069.          offering beta test site status to the first group of registered DRT
  1070.          SysOps (Look for the early stages of DRT v2.0 by second/third quarter
  1071.          '93).
  1072.